# 交易过程记录

## 开启交易日志

在 **qt.run(..., trade_log=True)** 中设置 **trade_log=True** 即可在回测时记录每笔交易。相关配置（如日志保存路径）以 **qt.configure()** 或运行环境为准。

## 日志内容说明

交易日志通常包含以下字段（罗列并简短解释），具体以实际输出为准：

| 字段 | 含义 |
|------|------|
| 时间/日期 | 成交时间或日期。 |
| 标的 | 股票/合约代码。 |
| 方向 | 买入/卖出。 |
| 价格 | 成交价格。 |
| 数量 | 成交数量。 |
| 金额 | 成交金额。 |
| 费用 | 佣金、印花税等。 |
| 备注 | 其他说明（若有）。 |

## 查看与保存

- **查看**：回测结束后可通过结果对象或 API 读取 trade_log（如 DataFrame 或文件路径）。
- **保存**：若框架将日志写入文件，路径由配置项 **trade_log_file_path** 决定（支持相对/绝对/家目录路径，可通过 **qt.configure()** 热修改），详见 API 文档。
- **日志轮转（rotate）**：当 **trade_log_keep_days** 为正整数时，qteasy 在 **进程启动、成功导入 `qteasy` 模块之后**，按该保留天数对当前 **trade_log_file_path** 目录执行 **一次** 清理：删除早于保留期的 `trade_log_*.csv`、`trade_summary_*.csv` 与 `value_curve_*.csv`（文件名中的时间戳或文件 mtime 用于判断新旧）。**不会在**每次回测结束写新 CSV 之前再次自动清理；长时间运行的单次会话中若产生大量文件，可调用 **`qt.rotate_trade_logs()`** 手动清理。默认 **trade_log_keep_days** 为 **3**；设为 **None** 或 **小于等于 0** 可关闭自动删除。轮转仅影响磁盘上的旧文件，不改变回测结果或任何对外 API。

## 与 result 的关系

- trade_log 与回测的 **loop_result**、**oper_count** 对应：每笔记录对应一次实际操作，oper_count 可为汇总统计。
- 用于核对回测过程与绩效指标的一致性。